home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / tools / czesc_1 / asjocookiebox_1.0 / asjocookiebox_1.0.man next >
Text File  |  1994-04-09  |  3KB  |  134 lines
  1.  
  2.                              asjoCookieBox 
  3.                               version 1.0
  4.              The Amiga Cookie Shower and Indexer collection
  5.  
  6.                    Free software 1994 by Adam Sjøgren
  7.  
  8.           asjoCookieBox 1.0 - Random cookie display programs.
  9.  
  10.  
  11. 0 Abstract
  12.  
  13. asjoCookieBox is a collection of programs, two actually, which can
  14. display a random (fortune or whatever you like) cookie when invoked.
  15.  
  16.  
  17. 1 Files included
  18.  
  19.   asjoCookieBox_1.0.man                    - This file
  20.   CookieIndex                              - CookieIndex 1.0
  21.   Sample.dat                               - Sample cookies
  22.   Sample.ptr                               - Pointers for them
  23.   ShowCookie                               - ShowCookie 1.0
  24.   Source/CookieIndex/CookieIndex_protos.h  - Protos for CookieIndex
  25.   Source/ShowCookie/SCOPTIONS              - SAS/C 6.51 options
  26.   Source/ShowCookie/ShowCookie.c           - Source for ShowCookie
  27.   Source/ShowCookie/ShowCookie_protos.h    - Protos for ShowCookie
  28.  
  29.   + icons.
  30.  
  31.  
  32. 2 Requirements
  33.  
  34. CookieIndex requires dos.library v37 or above (AmigaDOS release 2.04).
  35. ShowCookie requires utility.library v39 or above (AmigaDOS release 3.0)
  36. and dos.library v37 or above (AmigaDOS release 2.04)
  37.  
  38.  
  39. 3 Installation
  40.  
  41. Copy CookieIndex and ShowCookie to someplace you find suitable
  42. (somewhere in the path would be preferable). Copy the sample files too,
  43. of you want to try them.
  44.  
  45.  
  46. 4 How to use
  47.  
  48. CookieIndex makes the .ptr file given an input .dat file. The template
  49. is like this:
  50.  
  51.   COOKIEDAT/A,COOKIEPTR/A:
  52.  
  53. Example:
  54.  
  55.   [18] (0) $ CookieIndex Sample.dat Sample.ptr
  56.   Cookies indexed: 15
  57.  
  58. ShowCookie shows a random cookie given a .ptr and the corresponding .dat
  59. file. The template is:
  60.  
  61.   COOKIEDAT/A,COOKIEPTR/A:
  62.  
  63. Example:
  64.  
  65.   [18] (0) $ ShowCookie Sample.dat Sample.ptr
  66.  
  67.   "I've got it again, Larry ... an eerie feeling like there's something on
  68.   top of the bed."
  69.  
  70. 5 The structure of .dat files
  71.  
  72. The .dat file contains the cookies, each of them surrounded by ascii 12
  73. (Formfeed) characters.
  74.  
  75.  
  76. 6 Todo's
  77.  
  78.   * Replace GetUniqueID() in ShowCookie to make it v37 compatible.
  79.  
  80.   * More cookies in the Sample.dat
  81.  
  82.  
  83. 7 Distribution
  84.  
  85. You are free to copy this program. If you use it, please send me an
  86. email!
  87.  
  88.  
  89. 8 The author
  90.  
  91. These programs was written by me, because another program I had that was
  92. supposed to do the same thing didn't work, I am:
  93.  
  94.   Adam Sjøgren
  95.   Falkonergårdsvej 13
  96.   DK-1959 Frederiksberg C
  97.   Denmark
  98.   
  99.   email:    asjo@inav.ping.dk or asjo@diku.dk
  100.   amiganet: 39:141/109 (I prefer email)
  101.  
  102.  
  103. 9 Bugs
  104.  
  105. If you find a bug, feel free to correct it yourself, but _please_ send
  106. me the corrected source, so I can include it in future releases (if any
  107. :-)).
  108.  
  109.  
  110. a History
  111.  
  112. 0.0 - Never released, internal developement (meaning: I hacked it
  113.       together for myself to use).
  114.       
  115. 1.0 - First release. (ShowCookie: 1012 bytes, IndexCookie: 568 bytes).
  116.  
  117.  
  118. b Thanks
  119.  
  120.   * The author of that program that didn't work :-)
  121.  
  122.  
  123. c Legal mumbo-jumbo
  124.  
  125. This software is free as long as you do not make money on it.
  126. (I hate long legal texts).
  127.  
  128.  
  129.  
  130.  "Wiggle, wiggle, wiggle like a bowl of soup"
  131.  
  132.     /asjo (Sat Apr  9 16:46:58 1994)
  133.  
  134.